home *** CD-ROM | disk | FTP | other *** search
/ Atari Mega Archive 2 / Atari Mega Archive CD - Volume 2.iso / 8bit / cislib_b / pltchr.doc < prev    next >
Text File  |  1995-04-22  |  2KB  |  66 lines
  1.  
  2.                                      PLTCHR 
  3.  
  4.  
  5.    PLTCHR is a BASIC subroutine to put ATASCII text characters on a graphics 
  6. screen, even redefined characters. The size of the text characters will depend 
  7. on the graphics mode which has been set. Only horizontal text is supported. 
  8.  
  9.    IMPORTANT NOTES 
  10.  
  11.    1.  PLTCHR is fully self-relocatable, so it may be moved anywhere in memory. 
  12.    2.  The graphics mode must have been set before PLTCHR is called. The 
  13. location of the upper left hand corner of the first text character may be set 
  14. with a BASIC "POSITION" statement.  The row and column are automatically updated 
  15. as characters are placed on the screen. 
  16.    3.  An attempt to put characters outside of the visible screen will result in 
  17. an error. 
  18.    4.  Since PLTCHR uses the current character set, it will work with a 
  19. redefined character set. 
  20.    5.  An easy way to erase something is to output an inverse video blank in the 
  21. background color (which is black as a default). 
  22.  
  23.    CALLING 
  24.  
  25. RETURNCODE=USR(PLTCHR, SADR, SLEN) 
  26.  
  27.    PLTCHR:  The address of the PLTCHR subroutine [usually ADR(PLTCHRSTRING$)]. 
  28.    SADR:    Address of the string containing the text to be placed on the screen 
  29. [usually ADR(DATASTRING$)]. 
  30.    SLEN:    Total length of the text string [usually LEN(DATASTRING$)]. 
  31.  
  32.    RETURN CODES 
  33.  
  34.    0   Normal completion. 
  35.    1   Error in one of the arguments. 
  36.    >1  Standard Atari I/O error code. 
  37.  
  38.    DEMONSTRATION 
  39.  
  40.    PLTCHR.BIN is a simple tokenized BASIC (binary) program which will 
  41. demonstrate the PLTCHR subroutine. As a first test, try "7" for the graphics 
  42. mode, "12,12" for the column,row, and "2" for the color code; then type any 
  43. short text string that you like. Experiment with the demo to learn how to use 
  44. the subroutine. 
  45.  
  46.    USE 
  47.  
  48.    To use the subroutine, just transfer the statements 900-905 to your own 
  49. program (you could do a LIST "D:TEMP",900,905 from the demo followed by an ENTER 
  50. "D:TEMP" into your own program); of course, you can renumber the statements as 
  51. necessary. Remember to call the subroutine once at the beginning of your program 
  52. to set it up. 
  53.  
  54.    -John Navas [72645,1070] 
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.